home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / rafm111.zip / USERON30.ZIP / USERON.DOC < prev    next >
Text File  |  1991-11-07  |  4KB  |  115 lines
  1.  
  2.                                 -=( UserOn )=-
  3.  
  4.  
  5. What is it:
  6. ===========
  7.  
  8. Useron does almost exacly the same as the useron function of RA 1.0. There's
  9. only one single extra: Whenever a user has the 'external util/door' status
  10. UserOn looks in the RA Directory for a file USERDOES.<NodeNr>. This file
  11. may contain a more accurate description of which door that user entered.
  12. RA only reserves a byte and 6 predefined messages for this purpose, and I
  13. as a doorwrite would like to put the name of the program there.. Alas, this
  14. is not possible with RA, so I wrote this little replacement.
  15.  
  16. Source code (pascal)  for putting, reading and writing such a UserDoes file
  17. is included.
  18.  
  19.  
  20. How To:
  21. =======
  22.  
  23. Simply replace the ShowUsers call with a type 7 call with on the optional
  24. dataline:
  25.  
  26.  <Path>UserOn.exe -T:*T -N:*N [-P:*P] [-SYSOP] [-LINES:<NoLines>] [-AKA]
  27.                   [-NOS]
  28.  
  29. (The -P is only nessecary when you use a commport different from the one in the
  30.  Config.ra, the -N:*N should be there, as this program only makes sence in a
  31.  multiline RA setup)
  32.  
  33. -SYSOP    shows the sysop regardless of the config.ra settings
  34. -NOS      turns local sound off
  35. -AKA      Show handles instead of names.
  36. -Lines:   Turns the message to other line option on, and defines the
  37.           maximal number of lines of a message.
  38.  
  39. That's all.
  40.  
  41.  
  42. Programmers:
  43. ============
  44.  
  45. The USERDOES.<NodeNr> file is a simple textfile with only one line of text,
  46. Maximal 70 characters long. (should be enough..;)
  47. It's expected to be found in the directory where the RA environment variable
  48. is pointing to. Note that the <NodeNr> part has NO leading zeros!
  49.  
  50.  UserDoes.1   is a legal name
  51.  UserDoes.001 will never be found.
  52.  
  53. If you use the DoIt.Pas unit, things are simpler:
  54.  
  55. Put somewhere in the initialization part of your program the lines:
  56.  
  57. DoingWhat='Your text which has to appear';
  58. SetDoingInfo(NodeNr);
  59.  
  60. And at the end of the program a line:
  61.  
  62. ClearDoingInfo(NodeNr);
  63.  
  64. Even more fun is to update the userdoes during the game, reflecting the
  65. user's score...;) (RA-Pong, and Richard's Faassen's TETRA do this..)
  66.  
  67. CopyWrong: you are encouraged to include this program with your own programs
  68.            as long as you include the WHOLE package......
  69.  
  70.  
  71.  
  72. Using this program with existing utils and doors:
  73. =================================================
  74.  
  75. Well, from a type 7 menuitem with out a batch you're out
  76. of luck until (and IF) the author of the program supports this
  77. way of showing his info. (Unless of course you use the Type 7 to
  78. call a batchfile..;-)
  79.  
  80. From a type 15 things are easier, just put a line :
  81.  
  82.   Echo <The text to appear> > c:\RA\userdoes.%1
  83.  
  84. into the batchfile and things should work! The %1 reflects the nodenr here.
  85.  
  86. At the end of the batch you can delete the file with a simple
  87.  
  88.   del c:\ra\userdoes.%1
  89.  
  90. !!!!  RA 1.10  !!!!
  91.  
  92. RA 1.10 stores the message files in the semafore directory! If you use
  93. this directory, Useron will use it too for the USERDOES and the message
  94. files.
  95.  
  96.  
  97.  
  98. Last words:
  99. ===========
  100.  
  101. Just in case: you're using this program at your own risk! Never will I accept
  102. any responsibility for anything happening due to the behavior of this program!
  103.  
  104. This program is freeware. Do with it whatever you like. and if you are a
  105. door-programmer yourself, consider supporting the idea.. After all,
  106. when the useron info says something like:
  107.  
  108.     > User having a good time playing multiline-tradewars
  109.  
  110. The odds are that other users jump in..;-)
  111.  
  112. Enjoy!
  113.  Gerhard
  114.  
  115.